home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / ra_mess6.zip / RA_MESS.DOC < prev    next >
Text File  |  1991-06-17  |  18KB  |  435 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.      ▒▒▒▒▒▄           ▒▒▒▒▄           ▒▒    ▒▒▄  ▒▒▒▒▒▒▄  ▒▒▒▒▒▒▄  ▒▒▒▒▒▒▄
  15.      ▒▒█▀▒▒▄         ▒▒█▀▒▒█          ▒▒▒  ▒▒▒█  ▒▒█▀▀▀▀  ▒▒█▀▀▀▀  ▒▒█▀▀▀▀
  16.      ▒▒▒▒▒█▀         ▒▒▒▒▒▒█          ▒▒█▒▒█▒▒█  ▒▒▒▒▒▄   ▒▒▒▒▒▒▄  ▒▒▒▒▒▒▄
  17.      ▒▒█▀▒▒▄         ▒▒█▀▒▒█          ▒▒█ ▀▀▒▒█  ▒▒█▀▀▀       ▒▒█      ▒▒█
  18.      ▒▒█ ▒▒█   ▒▒▄   ▒▒█ ▒▒█   ▒▒▄    ▒▒█   ▒▒█  ▒▒▒▒▒▒▄  ▒▒▒▒▒▒█  ▒▒▒▒▒▒█
  19.       ▀▀  ▀▀    ▀▀    ▀▀  ▀▀    ▀▀     ▀▀    ▀▀   ▀▀▀▀▀▀   ▀▀▀▀▀▀   ▀▀▀▀▀▀
  20.  
  21.                  Call/Message Ratio Checker for Remote Access
  22.  
  23.                                   Version 6
  24.  
  25.  
  26.                       Copyright (C) 1990 by Alain Poupart
  27.  
  28.                              All Rights Reserved
  29.  
  30.  
  31.  
  32. ╓─────────────────────────────────────────────────────────────────────────────╖
  33. ║ ░░░░░░░ Introduction ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  34. ╙─────────────────────────────────────────────────────────────────────────────╜
  35.  
  36.    This program works ONLY with Remote Access, unless QuickBBS has changed the
  37.    structure of some files to be 100% compatible with Remote Access
  38.    (why not this way around ... for a change...).
  39.    If you are willing to test it with Quick BBS, it's all yours....but don't
  40.    complain to me if it doesn't work or leave some garbage.....
  41.    You have been notified.... so now.... I can rest in Peace...
  42.  
  43.  
  44. ╓─────────────────────────────────────────────────────────────────────────────╖
  45. ║ ░░░░░░░ Purposes ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  46. ╙─────────────────────────────────────────────────────────────────────────────╜
  47.  
  48.  
  49.    Have you ever wonderred why your BBS never seems to have any lively
  50.   converstions going on in it's message areas?  Are you disappointed when
  51.   you look at your logs and see hour after hour of downloads, with the users
  52.   sending you 5 year old programs back in order to maintain their download
  53.   credit ratio, or spend all of their online time playing games, without
  54.   ever talking to each other or you?  Really!  What is a BBS for anyway?
  55.   It's an electronic BULLETIN BOARD! A bulletin board must have MESSAGES!
  56.  
  57.    If you feel this way, as I do, then RA_MESS is for you.  RA_MESS allows
  58.   you, the Sysop, the freedom to require your users to talk to each other,
  59.   automatically, without undue hassles.  The program was designed for the
  60.   Sysop who prefers to have his users communicate with other users, rather
  61.   than worry about who is uploading what.
  62.  
  63.    Ra_Mess sets user security levels or flags based on the ratio of the
  64.   average number of calls per message posted on the board.
  65.  
  66.    Features include:
  67.  
  68.       - "Kill" users at or below a pre-determined access level.
  69.            ( Level 0 and "Special" users are not affected)
  70.  
  71.       - "Kill" users that have a "Tourist" type behaviour.
  72.  
  73.       - Bonus VIP level for the those that maintain an average of one message
  74.         per call. However, they won't stay there if they slow down.
  75.  
  76.       - Make charts of users "in danger" - RAMESS.ANS & RAMESS.ASC
  77.  
  78.       - Keep track of of the changes to user's record ---> RATIO.LOG
  79.  
  80.       - A separate VIP flag that can be used to insulate your "special" users
  81.         from RA_MESS actions.
  82.  
  83.       - You can elect to use the flag mode or the security level mode
  84.         (or both) to differentiate users that are above or below ratio
  85.  
  86.       - You decide where posting doesn't count ( like comment to Sysop )
  87.  
  88.       - Cheating is controlled.... message deletion just after posting is
  89.         checked .... and user's record is adjusted accordingly...!!!
  90.  
  91.       - Special bonus time for your "special" users.
  92.  
  93.  
  94.  
  95.    The only thing RA_MESS can't do is read.  It can't monitor the content of
  96.   posted messages. You'll soon see however that this won't really be a
  97.   problem.  Your good users, who do their part in keeping the BBS alive and
  98.   healthy, will soon see right through those who post garbage messages just
  99.   to improve their ratio.  A few words of "wisdom" from them is usually all
  100.   it takes to put a stop to abusers.  This program is easy to set up and
  101.   install.  Give it a try.
  102.  
  103.  
  104. ╓─────────────────────────────────────────────────────────────────────────────╖
  105. ║ ░░░░░░░ Utilization ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  106. ╙─────────────────────────────────────────────────────────────────────────────╜
  107.  
  108.    IMPORTANT:
  109.  
  110.    RA_MESS must be run from the same directory that contains the following
  111.     files:
  112.              Config.Ra, Lastcall.Bbs, Ramess.Cfg
  113.  
  114.    Ra-Mess must be called from the main batch file after each user logs off.
  115.              Example batch file segment:
  116.               .
  117.               IF ERRORLEVEL 0 GOTO MONITOR
  118.               .
  119.               :MONITOR
  120.               cd \ra
  121.               RAM_6286     (or RAM_6XT)
  122.               GOTO START
  123.  
  124.    The graphic files, RAMESS.ANS and RAMESS.ASC may be called and displayed
  125.    using the RA type 5 menu.
  126.  
  127.  
  128.  
  129. ╓─────────────────────────────────────────────────────────────────────────────╖
  130. ║ ░░░░░░░ Configuration File ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  131. ╙─────────────────────────────────────────────────────────────────────────────╜
  132.  
  133.  RA_MESS uses one of two .EXE files depending on the type of system you
  134.  operate. Choose the one that matches your system and place it in the
  135.  same directory that your system files are in, ie; RA.EXE. In addition,
  136.  the following files must be present in this same directory; LASTCALL.BBS,
  137.  CONFIG.RA and the config file, RAMESS.CFG.
  138.  
  139.     RAM_6XT.EXE   for XT type computers
  140.     RAM_6286.EXE  for AT type (286, 386 and 486) computers
  141.  
  142.  RA_MESS6 will look into CONFIG.RA for the location of USERS.BBS as well
  143.  as the Message related files M*.BBS, and the location of the text and
  144.  graphic files. The RA_MESS display files, RAMESS.ANS and RAMESS.ASC will
  145.  be written into the same directory as the text and graphic files.
  146.  
  147.  The program operates as follows;
  148.  
  149.  1 - Users with messages posted > 0  and sec level > KIL level are exposed
  150.      to ramess sanctions ( i.e. LNOR, LLOW, LVIP ).  Note: LVIP will only
  151.      be affected when the user has called more times than RAM value.  A message
  152.      will be posted to the user of any change in status.  The ANSI and ASCII
  153.      screens will be redrawn
  154.  
  155.  2 - Users with FVIP flag set;
  156.      Program will exit without doing anything except making a log entry
  157.      ( if LOG option is ON )
  158.  
  159.  3 - Users with sec level 0 or already killed;
  160.      Program will exit without doing anything except making a log entry
  161.      ( if LOG option is ON ).
  162.  
  163.  4 - Users with LLOW > sec lvl and > KIL level and 0 msg posted;
  164.      Program will exit without doing anything except making a log entry
  165.      ( if LOG option is ON ).
  166.  
  167.  5 - Users with sec lvl =< KIL level and 0 msg posted;
  168.      User is marked for deletion and program exits. The user will be deleted
  169.      during the next normal RAUSER run.
  170.  
  171.  6 - Users with msg ratio => DEL setting;
  172.      User is marked for deletion and program exits. The user will be deleted
  173.      during the next normal RAUSER run.
  174.  
  175.  7 - If the user's name is the same the Sysop's name as found in CONFIG.RA,
  176.      program will exit with no action. For testing purposes, the program may
  177.      be run with the command line parameter $5.00. In this case, the program
  178.      will run as normal regardless of the user name.
  179.  
  180.  8 - In the case of a local logon;
  181.      Pogram will exit with no action. For testing purposes, the $5.00
  182.      parameter may be used as above.
  183.  
  184.  
  185.  
  186.  9 - Your LIMITS.CTL file must be adjusted to reflect the user levels you
  187.      select with the LLOW, LNOR and LVIP settings.  You can adjust allowed
  188.      daily online time as well as download limits for each level in this
  189.      manner. An example would be to have LLOW at sec level 10.  You could
  190.      then limit online time and Kbytes with LIMITS.CTL and also use FLOW to
  191.      limit access to various areas of the BBS.  Then, by using a higher
  192.      level for LNOR, let's say level 20, you could increase online time and
  193.      Kbytes, and use the FNOR flag to give access to all areas of the BBS.
  194.      With the LVIP level then set even higher, say level 30, you could
  195.      increase online time and Kbytes even more for those active users. Should
  196.      you have a "special" user that you don't want restricted in any way,
  197.      set the Fvip flag in his user file to the one set up in RAMESS.CFG. He
  198.      will never be botherred by RAMESS.
  199.  
  200.  *** Config file parameters are set up as follows ***
  201.  
  202.  Sets LOW security level - below ratio limit  [ option ]
  203. LLOW50
  204.  
  205.  Sets NORMAL security level - above ratio limit and below 1 to 1 [ option ]
  206. LNOR60
  207.  
  208.  Sets VIP security level - ratio better than 1 to 1 [ option ]
  209. LVIP70
  210.  
  211.  LOW flag - below ratio limit  [ option ]
  212. FLOWA6
  213.  
  214.  NORMAL flag - above ratio limit [ option ]
  215. FNORA7
  216.  
  217.  VIP flag. Must be turned on manually. User will not be affected by RA_MESS.
  218. FVIPA8
  219.  
  220.  Deletion level - user with this security level and below are "killed"
  221.  with the exception of users with sec level 0 !!!!  [ option ]
  222. KIL5
  223.  
  224.  Maximum authorized message ratio before deletion occurs.  Eliminates those
  225.  who never post. [ option ]
  226. DEL100
  227.  
  228.  Ratio of calls per message posted to maintain. The default is 5;
  229. RAM4
  230.  
  231.  Message base numbers where posting doesn't count  (up to 10) [ option ]
  232. BOARD2
  233. BOARD3
  234. BOARD10
  235.  
  236.  Writes RATIO.LOG file in system directory [ option ]
  237. LOG
  238.  
  239.  
  240.  
  241.  This setting is a special bonus for your FVIP users.  It allows you to give
  242.  your special users additional time online BUT only if they use it in during
  243.  multiple sessions.  This is an incentive for them not to use all their time
  244.  during what may be the prime hours of the day.  The time spent online for
  245.  the day is divided by the BONI factor and the result is then subtracted from
  246.  that same time already spent online.  This result is then subtracted from
  247.  the daily limit, and time remaining is adjusted to the resulting number.
  248.  
  249.  i.e. time spent online today: 45 minutes
  250.       BONI factor set at 1.5
  251.       Daily time limit 60
  252.           45 / 1.5 = 30 minutes
  253.           60 - 30 = 30 minutes
  254.       On the users next call that day, he will show 30 minutes time
  255.       remaining for the day, instead of the 15 he would otherwise have.
  256. BONI1.5
  257.  
  258.  Message base number into which RA_MESS will post the level change
  259.  notifications [ option ]
  260. MSGB2
  261.  
  262.  The text of the level change message that you want posted to your users
  263.  for each condition. These examples may be changed to suit your needs. A
  264.  maximum of 80 characters per line is allowed.  Additional lines may be
  265.  added, or excess lines deleted.  [ option ]
  266. MVIP
  267. MVIP                          CONGRATULATIONS!
  268. MVIP
  269. MVIP          You are maintaining a calls to posts ratio of 1 to 1
  270. MVIP          This qualifies you as a VIP member of Junior BBS.
  271. MVIP          As long as this ratio is maintained, you'll remain at
  272. MVIP          access level 70 with 75 minutes daily online time.
  273. MVIP          Thanks for being a good user.
  274. MVIP
  275. MVIP Message automatically generated by RA_MESS
  276.  
  277. MBAS
  278. MBAS                             ATTENTION!
  279. MBAS          Your post to call ratio has dropped below 1 post per
  280. MBAS          4 calls. Your access level has been reduced to level
  281. MBAS          50. This limits you to 30 minutes online time per day.
  282. MBAS          You still have access to all areas of the BBS except
  283. MBAS          the Timebank.  Access may be restored simply by
  284. MBAS          participation in the public message areas.
  285. MBAS
  286. MBAS          Note: Messages posted in echomail areas, Private Mail
  287. MBAS                and mail to the Sysop are not counted toward
  288. MBAS                the required 4 to 1 ratio.
  289. MBAS
  290. MBAS Message generated automatically br RA_MESS
  291.  
  292. MNOR          You have reached access level 60 here at Junior BBS
  293. MNOR          by maintaining a call to post ratio of 4 to 1.
  294. MNOR          This level allows you 60 minutes online time daily
  295. MNOR          and full access to the BBS. Should you reach a ratio
  296. MNOR          of 1 to 1, you will be elevated to level 70.
  297. MNOR          Thanks for your participation.
  298. MNOR
  299. MNOR Message generated automatically by RA_MESS
  300.  
  301.  
  302.  
  303.    - Only Keywords are recognized by the program. DON'T insert any spaces
  304.      between keywords and values, ie;
  305.                                       CORRECT:   LLOW30
  306.                                       INCORRECT: LLOW 30
  307.      The exceptions to this rule are the level change messages.
  308.  
  309.    - Keywords must start at column 1 on each line.
  310.  
  311.    - One Keyword per line.
  312.  
  313.    - Configuration file must be nammed RAMESS.CFG
  314.  
  315.    - Lines beginning with a semicolon are ignored
  316.  
  317. ╓─────────────────────────────────────────────────────────────────────────────╖
  318. ║ ░░░░░░░ Default Values ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  319. ╙─────────────────────────────────────────────────────────────────────────────╜
  320.  
  321.     If some parameters are not mentionned on the command line, they will take
  322.     following values:
  323.  
  324.               RAM ==> 10
  325.              LLOW ==> 15  if LVIP or LNOR are used and LLOW is missing
  326.              LNOR ==> 20  if LVIP or LLOW are used and LNOR is missing
  327.              LVIP ==> 50  if LNOR or LLOW are used and LVIP is missing
  328.  
  329.     if KIL, DEL, LOG, parameters are not used, these functions are ignored
  330.  
  331.  
  332. ╓─────────────────────────────────────────────────────────────────────────────╖
  333. ║ ░░░░░░░ Credits ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  334. ╙─────────────────────────────────────────────────────────────────────────────╜
  335.  
  336.     Aime Franche - Sysop of Le Courrier     - 1:167/180 - St Lambert
  337.      "If it works for him ..... It must work for you ...!!!"
  338.      If you are looking for a "GOOD" beta tester, contact Aime.
  339.      When he tells me that something is wrong, I take his word
  340.      and don't argue....
  341.  
  342.     Al Chapman - Sysop of Squiggy's Place - 1:282/70 - Cottage Grove, Mn.
  343.      Thanks for your suggestions.... they are always welcomed !!!
  344.  
  345. ╓─────────────────────────────────────────────────────────────────────────────╖
  346. ║ ░░░░░░░ The Final Word ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  347. ╙─────────────────────────────────────────────────────────────────────────────╜
  348.  
  349.     This program is provided as it.... without warranty of any kind.
  350.     I trust it enough to have it installed permanently on my board,
  351.     It works for me, it should work for you.....
  352.  
  353.     Call it Freeware, paperware, anyware, as you wish. There is no charge.
  354.     It has take some of my rare spare time to program it though, so any form
  355.     of recognition for time and effort spent is always appreciated.
  356.  
  357.     If you have questions or want to know more about the program, I can be
  358.     reached via Netmail or EchoMail. Be advised however, that I do not make
  359.     long distance calls.  All of my mail is routed through Fido-Net.
  360.                                  Be Patient!
  361.                                 Alain Poupart
  362.  
  363. ╓─────────────────────────────────────────────────────────────────────────────╖
  364. ║      Comments, suggestions, bug reports, donations, I can be reached at     ║
  365. ║                                                                             ║
  366. ║              2179 Dumouchel - Laval - Quebec - Canada - H7S 2H9             ║
  367. ║                                                                             ║
  368. ║   ██▓▓▒▒░░  JUNIOR BBS ░░▒▒▓▓██  1:167/118 ∞  514-686-1547   ≡ 24 hours ≡   ║
  369. ╙─────────────────────────────────────────────────────────────────────────────╜
  370.  
  371.  
  372. ╓─────────────────────────────────────────────────────────────────────────────╖
  373. ║ ░░░░░░░ Revisions ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  374. ╙─────────────────────────────────────────────────────────────────────────────╜
  375.    Version 1.0  - July 1st,1990
  376.                The original version.......
  377.  
  378.    Version 1.1  - July 15th,1990
  379.                This is proof that someone is using it, or at least interested.
  380.  
  381.                Flexibiliy added....
  382.                   Now you can select the way you want to make the difference
  383.                between "good" users and "bad" ones.
  384.                   Security levels LNOR and LLOW are now otpional as well as
  385.                FLOW and FNOR, you can use any combination of flag only,
  386.                security level only, or both flag and security level.
  387.                   Logging is now optional.
  388.  
  389.    Version 1.2  - July 22nd,1990
  390.  
  391.                 Bugs removed:
  392.                  First of all, some of the parameters described in the doc
  393.                 where wrong because I'm working in parallel on the french and
  394.                 the english version.
  395.  
  396.                 Removed:
  397.                  The NOP option has been removed, now, I no longer have to write
  398.                 proprietary data in the users.bbs file
  399.  
  400.                 Revised:
  401.                  FVIP level added.
  402.                  Real VIP users can be protected by using a flag that you
  403.                 turn ON manually in user's record. Such users will not be
  404.                 subject to RA_MESS calculations.
  405.  
  406.                  LVIP security level is now just a bonus level for those that
  407.                 keep a call/message ratio of 1 to 1. This allows an additional
  408.                 level.  There is no other protection for these users, as opposed
  409.                 to FVIP which protects users from the program.
  410.  
  411.  
  412.    Version 5.0  - May 1991
  413.  
  414.                   Yep... several revision later.... I lost my sources when
  415.                 I installed another drive... they where not backed up... Oops!
  416.  
  417.                   Major revision,
  418.  
  419.                 - Only the last caller record is analysed after a call.
  420.                 - Users.bbs,Usersxi.bbs,Lastread.bbs are no longer re-written.
  421.                 - You must use Rauser to pack the users files daily.
  422.                 - Up to 10 pre-determined message boards can be specified in
  423.                   which posting will not be credited
  424.                 - Sends messages to users after acess level changes are made.
  425.  
  426.  
  427.  
  428.    Version 6.0  - June 1991
  429.  
  430.                 Bug fixes.
  431.                 - Now has 2 .EXE files, one for XT class, and another for
  432.                   AT class machines.
  433.                 - LVIP users were not being awarded status, now fixed.
  434.  
  435.